home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / dep_33.zip / DEP_33.DOC next >
Text File  |  1993-01-06  |  21KB  |  463 lines
  1.  
  2.                 Online INSTAbank 3.3 Public Release Version
  3.                 ───────────────────────────────────────────
  4.                     (C) 1992, 1993,  William J. Dykstra
  5.  
  6.  
  7.         Online INSTAbank is a Borland Pascal 7.0 application written
  8.         for Remote Access 1.11 and compatable versions.  This program
  9.         will allow users to deposit and withdraw time and bytes.
  10.         The sysop may configure the maximum daily deposits and
  11.         withdrawals, as well as the maximum balances.  There is also
  12.         a Rob the Bank feature, which may be enabled or disabled by
  13.         the sysop.
  14.  
  15.         This program has been extensively tested on my BBS, and has
  16.         not caused any problems.  There is, of course, absolutely NO
  17.         WARRANTY of any kind!  This program may work for you, or it
  18.         may not!  It will NOT WORK WILL ALL VERSIONS OF THE BNU Fossil
  19.         driver.  It works fine with X00, but has been known to
  20.         lockup BNU systems.  If you use the BNU .SYS file instead of the
  21.         BNU .COM file, you will probably have better luck with the program.
  22.  
  23.         This program is being distributed as FREEWARE.  That's right,
  24.         its gonna cost you all of zero dollars to register it.  You
  25.         *MUST*, however, register it after 10 days of trial use.
  26.         Please see the section about registration at the end of this 
  27.         document for more details.
  28.  
  29.         Major Features of Online INSTAbank:
  30.           * users may deposit and withdraw time and bytes
  31.           * sysop may set the following limits:
  32.              - Maximum Time/Byte Balances
  33.              - Maximum Daily Time/Byte Deposit
  34.              - Maximum Daily Time/Byte Withdraw
  35.           * Rob the Bank feature allows a user to steal time and bytes
  36.             from either the bank or another user (May be disabled)
  37.           * FREE registration!
  38.           * Supports RA 1.11 and compatable versions
  39.           * Will not allow a user to take out time if it would cause
  40.             a conflict with the next scheduled system event
  41.             (reads system event as defined in RA, or from time left
  42.              according to DOBBS.BAT if you use a mailer like Front Door)
  43.           * specify path a filename of log file (big deal)
  44.           * Mulitnode support
  45.  
  46.  
  47. New to version 3.3
  48. ──────────────────
  49.      Version 3.3 added support for multiple bank account limits, based on
  50.      security level.  In other words, users with one security level may have
  51.      a limit of say, 2000 kb and 120 minutes (max balances) while a user
  52.      with another security level might be limited to 1000kb and 60 minutes.
  53.      You may define up to 100 different security levels, each with its own
  54.      daily deposit and withdrawal limits for time and bytes, and each with
  55.      its own maximum byte and time balances.
  56.  
  57.      Please note there is a new configuration file required for this version
  58.      and there is also major changes made to the old configuration file.
  59.      Don't worry, the changes to the old file simply require deleting the
  60.      last 6 lines...
  61.  
  62.      Version 3.3 also FINALLY fixes a problem with event time calculations.
  63.      Sorry about all the troubles with this, but there are all kinds of
  64.      wierd situations that can come up, and a few of them got missed (namely,
  65.      what happens if there is NO event scheduled?)
  66.  
  67.  
  68.  
  69. New to version 3.2b
  70. ───────────────────
  71.      Version 3.2b simply fixed a bug that was showing up now and then with
  72.      systems running Front Door (or other mailers using DOBBS.BAT).  This
  73.      bug was causing the Minutes Until next System event to be read
  74.      incorrectly by the time bank when Remote Access was run with the -T
  75.      parameter.  This should fix that bug.  Everything else remained the
  76.      same.
  77.  
  78.  
  79. New to version 3.2
  80. ──────────────────
  81.      Version 3.2 added a feature to read the DOBBS.BAT file that is created
  82.      by various BBS front end mailers such as Front Door.  Online INSTAbank
  83.      will not allow a user to withdraw any time if that withdrawal would
  84.      allow a user to remain online during a scheduled system event.  Until
  85.      now, the next scheduled system event was read from EXITINFO.BBS, which
  86.      Remote Access creates when a user runs an external door.  If you run
  87.      a program such as Front Door, however, you will usually allow the front
  88.      end mailer to handle all events.  If you have not defined the events in
  89.      Remote Access, though, the bank will not know about the event!
  90.  
  91.      These mailer programs often create a file called DOBBS.BAT, which
  92.      contains the current baud rate, com port, and minutes until the next
  93.      event.  You may now tell Online INSTAbank to read this file to
  94.      determine if they may withdraw time or if there is an event in the way.
  95.  
  96.  
  97.      NOTE: DOBBS.BAT is not modified when a user logs in locally, so it will
  98.            not read DOBBS.BAT when a local user is in the bank.
  99.  
  100.  
  101. New to version 3.1
  102. ──────────────────
  103.      Version 3.1 added support for multinode systems.  A temporary file is
  104.      created in the path to the bank files directory you specify, called
  105.      DEPINUSE.TMP.  It is deleted when the user in the bank exits the program.
  106.      
  107.      Line 7 of the configuration file specifies the Path to the Bank Files.
  108.      The bank files are the various data files used by the bank for storing
  109.      the accounts.  You might want to set this to a separate directory, or
  110.      to the main RA directory.  If you are running multiple nodes, you will
  111.      need to keep a separate configuration file in each LINE directory.
  112.      Each configuration file should point to the SAME bank files (line 7).
  113.      Each configuration file should point to its own LINE directory as the
  114.      path to the RA system files (EXITINFO.BBS and DORINFO1.DEF) (LINE 8).
  115.      By doing this, only ONE set of bank data files are used, but each node
  116.      will use the proper EXITINFO.BBS and DORINFO1.DEF files.
  117.     
  118.      For example, if you had a two line system, with the RA system directories
  119.      \RA\LINE1 and \RA\LINE2 for the two nodes, then you would run one copy
  120.      of DEPOSIT from the \RA\LINE1 directory and the other from the \RA\LINE2
  121.      directory.  Store a separate config file in each directory.  Note you must
  122.      run DEPOSIT from the same directory that stores the config file, therefore
  123.      you must have a copy of DEPOSIT.EXE in each LINE directory, or have it
  124.      in a directory in your PATH statement, so it can be found when the LINE
  125.      directory is the CURRENT directory.  The config file will only be found
  126.      if it is in the CURRENT directory.
  127.      
  128.      If a user tries to access the deposit door, but it is already in use, they
  129.      will be notified that the door is in use, and the program will exit with
  130.      ERRORLEVEL 11.  You probably won't need this ERRORLEVEL, but its there
  131.      just in case.
  132.  
  133.  
  134.  
  135. Installing Online INSTAbank
  136. ───────────────────────────
  137.      To install the program, unzip the original ZIP file into your Remote
  138.      Access system directory, or into its own subdirectory.  Once you have
  139.      unzipped the archive, you must create (or modify) DEPOSIT.CFG.  This
  140.      is the configuration file, and is a standard ASCII file.  There should
  141.      be 9 lines in this file.
  142.  
  143.       Line 1 : Registration code.
  144.       Line 2 : Sysop Name
  145.       Line 3 : BBS Name
  146.       Line 4 : Rob Bank (YES or NO)
  147.       Line 5 : Sysop Security Level
  148.       Line 6 : Path and filename of Log file
  149.       Line 7 : Path to the Bank files (data files)
  150.       Line 8 : Path to RA system directory (DORINFO1.DEF and EXITINFO.BBS)
  151.       Line 9 : Path to DOBBS.BAT.  LEAVE THIS BLANK to disable this feature.
  152.                BE SURE YOU LEAVE A BLANK LINE FOR LINE 9 IF YOU DON'T USE
  153.                THIS FEATURE.  ENDING THE FILE AT 8 LINES WILL CRASH THE BANK!
  154.  
  155.  
  156.           Sample Configuration File:
  157.           -------------------------------------
  158.           000000000000
  159.           Sysop Name
  160.           BBS Name
  161.           YES        
  162.           32000
  163.           C:\RA\DEPOSIT.LOG
  164.           C:\RA\
  165.           C:\RA\
  166.           C:\FD\
  167.           -------------------------------------
  168.  
  169.      *NEW TO VERSION 3.3*
  170.      You must also modify a file called DEPOSIT.SEC.  This file MUST be
  171.      located in the directory with the bank's data files (the directory
  172.      specified as the Path to the Bank files (line 7 of config file)).
  173.      This file contains the various security levels and their limits.
  174.      You may have up to 100 different security levels defined, each on
  175.      its own line.  If you define more than 100 levels, the rest will be
  176.      ignored.  SPECIAL NOTE:  THE FIRST SECURITY LEVEL MUST BE 0.  This
  177.      will be the DEFAULT limits for all users.  If their security level
  178.      is not defined in this file, then the default limits will be used!
  179.  
  180.      DEPOSIT.SEC has this format:
  181.  
  182.               <SL> <MTD> <MTW> <MBD> <MBW> <MTB> <MBB>
  183.               <SL> <MTD> <MTW> <MBD> <MBW> <MTB> <MBB>
  184.               <SL> <MTD> <MTW> <MBD> <MBW> <MTB> <MBB>
  185.               etc..etc...etc...
  186.  
  187.         SL:  Security Level
  188.         MTD: Maximum Time Deposit (daily)
  189.         MTW: Maximum Time Withdraw (daily)
  190.         MBD: Maximum Kbyte Deposit (daily)
  191.         MBW: Maximum Kbyte Withdraw (daily)
  192.         MTB: Maximum Time Balance
  193.         MBB: Maximum Byte Balance
  194.  
  195.         example:
  196.              0 30 60 500 1000 120 4000
  197.             10 60 90 800 2000 240 4000
  198.  
  199.      In the above example, all users by default will have a the following
  200.      limits: Max Time Deposit=30 mins
  201.              Max Time Withdraw=60 mins
  202.              Max Byte Deposit=500 kb
  203.              Max Byte Withdraw=1000 kb
  204.              Max Time Balance=120 mins
  205.              Max Byte Balance=4000 kb
  206.  
  207.      and any user with security level 10 would have these limits instead of
  208.      the defaultss: Max Time Deposit=60 mins
  209.                     Max Time Withdraw=90 mins
  210.                     Max Byte Deposit=800 kb
  211.                     Max Byte Withdraw=2000 kb
  212.                     Max Time Balance=240 mins
  213.                     Max Byte Balance=4000 kb
  214.  
  215.      NOTE: The maximum value for each of these fields is 99,999.
  216.  
  217.      Once you have modified the configuration files, you need to install
  218.      the program to run as an external door from Remote Access.
  219.      The program should be installed as a type 7 external program in
  220.      RACONFIG.  Just run DEPOSIT.EXE to execute the program.  No other
  221.      parameters are necessary.  If you run into memory problems then you
  222.      may want to use DEPOSIT.EXE *M, to cause Remote Access to swap memory
  223.      before loading the door.  You should not need to do this however.  I
  224.      run the program without the *M parameter, both in DOS and Desqview
  225.      environments.
  226.  
  227.      The program will use ANSI colour codes if ANSI is enabled in the
  228.      DORINFO1.DEF file.  If the user uses ANSI on the BBS, then they
  229.      will have ANSI in the bank.  Avatar is NOT supported.   If they do
  230.      not have ANSI enabled then it will run in plain ASCII mode.
  231.  
  232.      Options available to the users:
  233.         The options that are available to users are:
  234.         - Deposit Time/Bytes
  235.         - Withdraw Time/Bytes
  236.         - List accounts
  237.         - Send message to another user (70 character max length)
  238.         - Rob the Bank (or another user) *only if enabled by sysop
  239.         - Quit
  240.         - * Sysop (available to any user who's security level matches
  241.                    the Sysop Security level setting in the config file)
  242.  
  243.      The Rob the Bank feature will not appear on the menu if the sysop
  244.      has disabled this feature.
  245.  
  246.      The sysop menu will only be available to users who have a security
  247.      level that is equal to or greater than the level you set in the
  248.      configuration file.  This option will NEVER be displayed on the 
  249.      menu, even if the user is allowed to access the function.  The
  250.      key to use to access the sysop menu is the * key.
  251.  
  252.      NOTE:  Install this as a type 7 menu option in RACONFIG.  You *MIGHT*
  253.             have to run it with the *M parameter, to cause Remote Access to
  254.             enable memory swapping when the program is run.  If you have
  255.             problems running the program (for example, if you see the
  256.             message UNABLE TO EXECUTE: C:\RA\DEPOSIT.EXE) then you probably
  257.             don't have enough memory available.  Enabling swapping should
  258.             fix this.
  259.  
  260.  
  261.  
  262. DEPMAINT.EXE - Maintenance Utility
  263. ──────────────────────────────────
  264.  
  265.         This program contains the same options that the Sysop menu in
  266.         DEPOSIT.EXE does.  This is for LOCAL use only, and is very
  267.         handy for changing account balances while a user is online.
  268.         You cannot use the sysop menu within the INSTAbank program
  269.         itself when a user is online, as it will read their info
  270.         from DORINFO1.DEF and EXITINFO.BBS.
  271.  
  272.         Running DEPMAINT /MAINT will CLEAN THE DATA FILES.  This
  273.         option should be used now and then to clean out the data
  274.         files.  Old messages (any messages that are marked as
  275.         read) will be deleted from the message file, and any users
  276.         that are no longer located in USERS.BBS will be deleted.
  277.         Accounts with no time and no bytes (empty accounts) will
  278.         also be removed.  The regular DEPOSIT.LOG file will indicate
  279.         who's accounts have been deleted.   You may run this program
  280.         in your nightly events if you desire.  (be sure to use the
  281.         /MAINT parameter!).
  282.  
  283.  
  284.  
  285. READMSGS.EXE - Message reader
  286. ─────────────────────────────
  287.  
  288.         This program will simply display all of the messages that are in
  289.         the message file.   Big deal.  (it also shows who sent the
  290.         message, and who the message is for.)
  291.  
  292.  
  293. Distributing Online INSTAbank
  294. ─────────────────────────────
  295.         Please feel free to distribute Online INSTAbank.  Please
  296.         distribute only the original archive, in unmodified form.
  297.         NO FEE MAY BE CHARGED for this program, other than fees
  298.         necessary to cover the cost of distribution.  This may be
  299.         included in shareware/freeware packages, such as CD-ROM disks
  300.         of shareware, etc.
  301.  
  302.  
  303.  
  304. Registering Online INSTAbank
  305. ────────────────────────────
  306.  
  307.         You must register Online INSTAbank after 10 days of evaluation
  308.         use.  If you continue to use the program after the 10 day trial
  309.         period, please register it.  Registration is *FREE*, so you have
  310.         no excuse to avoid registering.  There is a 5 second delay when
  311.         entering and exiting the program to encourage you to register.
  312.  
  313.         Why do I require registration if its FREE?  I want to know how
  314.         many people are using the program, so I can determine if furthur
  315.         development should be done.
  316.  
  317.         I will gladly accept suggestions and ideas for the program.  If
  318.         there is a feature you would like to see, let me know.  Also, 
  319.         PLEASE let me know if you encounter any bugs of any kind!
  320.  
  321.         Custom versions of the program may be written on request, for a
  322.         very modest fee (usually less than $25 Cndn).  If it is a very
  323.         small modification, and most are, then there will be no charge.
  324.         I will just consider it an "implemented suggestion".
  325.  
  326.  
  327.  
  328. Future Plans:
  329. ────────────
  330.  
  331.         Not too much is planned for the future, as this program pretty
  332.         well does what I want it to.  I was not going to release this
  333.         to the public, as I was just using it on my BBS, but after a 
  334.         few requests by local sysops, I decided to make a public release
  335.         version. 
  336.  
  337.         I may eventually add a Transfer feature, to allow users to send
  338.         some of their time/bytes to another user.  I may also add some
  339.         kind of vault breaker game to enhance (or replace) the current
  340.         bank robbery feature.
  341.  
  342.         Your ideas are welcome!  Send em to me!
  343.  
  344.  
  345.  
  346. --------[Cut Here]-------------------------------------------------------------
  347.  
  348.         Online INSTAbank      R E G I S T R A T I O N    F O R M
  349.         ~~~~~~ ~~~~~~~~~      ~~~~~~~~~~~~~~~~~~~~~~~    ~~~~~~~
  350.  
  351.        *Sysop Name: _______________________________________________
  352.  
  353.          *BBS Name: _______________________________________________
  354.  
  355.            Address: _______________________________________________
  356.  
  357.                     _______________________________________________
  358.  
  359.               City: ________________________ Prov/State: __________
  360.  
  361.    Postal/Zip Code: __________________  Country: __________________
  362.  
  363.          BBS Phone: __________________ Max Baud Rate: _____________
  364.  
  365.  
  366.    If you plan to call the BBS to pickup your registration code,
  367.    please fill out the following: 
  368.  
  369.         Real Name:_______________________________ (do NOT use an alias)
  370.  
  371.         Password to use:_________________________
  372.  
  373.         ANSI colour? (Yes or no):________________
  374.  
  375.         The number you will be calling from:_______________________
  376.          (this will be matched via call display)
  377.  
  378.         You *ONLY* need to fill out this information if you want me to
  379.         create an account ahead of time for you (and you are mailing this
  380.         form in. If you are simply going to call the BBS to get your
  381.         Registration code, don't worry about this logon info...)
  382.  
  383.  
  384.  
  385.    Where did you obtain your copy of Online INSTAbank?
  386.  
  387.    ________________________________________________________________
  388.  
  389.  
  390.    Comments/Suggestions:
  391.  
  392.    ________________________________________________________________
  393.  
  394.    ________________________________________________________________
  395.  
  396.    ________________________________________________________________
  397.  
  398.    ________________________________________________________________
  399.  
  400.    ________________________________________________________________
  401.  
  402.    ________________________________________________________________
  403.  
  404.    ________________________________________________________________
  405.  
  406.  
  407. --------[Cut Here - end of registration form]-------------------------------------------------------------
  408.  
  409.         Mail the above registration form to:
  410.  
  411.              Bill Dykstra
  412.              189 Bristol Road
  413.              Newmarket, Ontario. Canada.
  414.              L3Y 7X9
  415.  
  416.  
  417.         or call The BillBoard BBS
  418.                 (416) 898-2443
  419.                 14.4k v.32bis/v.42bis 8,N,1
  420.             and leave a message to Bill Dykstra (or sysop), with this
  421.             form file attached to the message.
  422.  
  423.  
  424.         If you would like me to send your registration code to you in the
  425.         mail, please include a self addressed stamped envelope (why should
  426.         I pay if you don't have to!?).  If you do NOT include an envelope,
  427.         then I will assume that you will be calling the BBS.
  428.  
  429.         I will create an account for you on the BBS if you fill out the
  430.         apropriate information above.  I will leave you a message with
  431.         your registration code in it.  Please allow enough time for the
  432.         letter to arrive here.  I will post a message with your reg. code
  433.         the same day that I receive your letter.  You do NOT have to mail
  434.         this form to me, however.  You may call the BBS, upload this form
  435.         to me (File attach it to a message), and then page me.  If I'm
  436.         around, I'll get your code on the spot.  If I am not around, you'll
  437.         have to call back.  I usually check mail every night at 5:45pm, as
  438.         well as at other random times.  If you leave a message before 5:30pm
  439.         it will almost surely be answered by 6:30pm.
  440.         (see above for BBS phone number)
  441.  
  442.        
  443.  
  444.         I hope this program works well for you, and you have no problems!
  445.  
  446.         Need an archive viewer?  Online Archive Master 3.8 is now available!
  447.         It is also FREEWARE, and is available on the BBS.  This program will
  448.         allow users to view the contents of ZIP, ARJ, LHA, LZH, ARC, and PAK
  449.         files while online.  They may also read files within the archive and
  450.         extract files to a separate extract zip file!  Check it out on
  451.         the BBS!
  452.  
  453.         These are both programs that I have written for my personal use on
  454.         my BBS, but, with the help of a few local sysops who kept bugging
  455.         me to release them, I have made public versions available.  Since I 
  456.         originally made them for my own use, and didn't intend them for
  457.         public release, I am making them freeware.  After all, the program
  458.         was there, so why not let others benefit from them?  I hope you
  459.         find them useful.
  460.  
  461.                 --Bill Dykstra
  462.  
  463.